home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
rbbs_pc
/
cb101a.zip
/
CALLBACK.DOC
< prev
next >
Wrap
Text File
|
1992-11-12
|
15KB
|
322 lines
Eric's CallBack Verification System for RBBS-PC
CallBack v1.01 (alpha) 11/10/92
Previous Release: Callback 1.19b (beta), 10/25/92. (in Clipper)
Copyright (c)1991,1992 Eric Givler, All Rights Reserved.
TABLE OF CONTENTS:
Features . . . . . . . . . . . . . . . . . . . . . . . . .1
History. . . . . . . . . . . . . . . . . . . . . . . . . .1
Disclaimer . . . . . . . . . . . . . . . . . . . . . . . .2
What You Should Have Received. . . . . . . . . . . . . . .3
Configuring. . . . . . . . . . . . . . . . . . . . . . . .3
Execution. . . . . . . . . . . . . . . . . . . . . . . . .4
Logfile Error Messages . . . . . . . . . . . . . . . . . .4
Upgrading From Previous Version. . . . . . . . . . . . . .5
Memory Used. . . . . . . . . . . . . . . . . . . . . . . .5
Registration And Other Information . . . . . . . . . . . .5
FEATURES:
o Easily configured by just entering the name CALLBACK at DOS.
o Uses industry standard Hayes modem commands for dialing. (ATDT,ATDP)
o Configurable to stay on-line after local callbacks.
o Configurable for Tone or Pulse dialing.
o Configurable option to perform long distance callbacks.
o Configurable locked baud rate (up to 38400) or use Dorinfo baud rate.
o Easily edit your local dialing area (area code and prefixes).
o Allows you to set level that users must have to access this program.
o Allows you to set level for validated users.
o Configurable to allow this program to reside in other directory.
o Easily edit the instruction screen (CALLBACK.TXT)
o Supports local and long distance dialing prefixes. (up to 6 numbers
each). For ld calls, the prefix would appear in the dial string
before the 1, ie. "917175618150" "9" would be the prefix.
o Configurable to not call numbers that already have validated users
for them.
o Configurable to limit # of calls (bad attempts) to a phone number.
o RBBS-PC USERS file need not be named USERS.
HISTORY:
v1.00 Fed up without having a callback verifier, I wrote CALLBACK v1.00.
I know, PCBVERIFY existed, but it was written for PCBoard and required
an additional program: RBBSPCBV, both of which required REGISTRATION.
Besides, I can write my own software! This version had NO
configuration capability and was tailored to work for me only, and it
did. Approximate programming time was about 2 hours. Over the next
several weeks, enhancement continued and I pondered additional
features until...
v1.10 The configurable version of CALLBACK was introduced. Configuration
information was stored in a dBASE .MEM file and read during startup.
v1.11 This version allows you to specify whether the system should stay
on-line on local callbacks. The configuration is available via
Setup. (starting CALLBACK without any command line switches)
1
v1.12 Minor *bug* fixes and cleaned up this documentation. No longer
date stamped (ie. Not Crippleware).
v1.13 Added support for local and long distance dialing prefixes.
Program displays the DORINFO filename it is trying to read, along
with the com port being accessed. Revised documentation adding
section describing what happens during execution. Added "DUMP"
option so sysop can dump the logfile to a text file: logfile.txt
in case sysop does not have dBASE access. Rewrote ALL input
routines so sysop can enter characters too (I used this for test
purposes, but this will make the transition to C/pascal EASIER.)
v1.14 Internal version. Only small documentation changes and clean-up
of code for easier readability. No code modifications. Never
released for general distribution.
v1.15 Added support to not callback #s that have been validated before.
Added support to limit # of calls to a certain phone number.
v1.16 Removed usage of DORINFO.DBF. Done as first step to ensure it
would work on multi-node systems. Callback now reads this using
low-level file i/o on a line-by-line basis.
v1.17 Changed RBBS default dir option to be RBBS USERS DIR & FILE.
The program was only working with rbbs-pc users files named
USERS. For example: C:\RBBS-PC\MAINU.DEF. As a note, the program
would then expect to find your DORINFO file in C:\RBBS-PC.
v0.01a Rewritten in Turbo Pascal v6.0. FOSSIL required!
DUMP option removed. The log information is stored in LOGFILE.DBF
as before. You must have a utility to read this dBASE file.
v1.01a Added support for RBBS-PC Hashing routine to find user quickly.
Time string in logfile now set to 24 hour military time.
Fixed glitches with Callback:
o Didn't close comport on certain errors.
o Fixed logfile dump - it would not show the first record.
o Exited with errorlevels other than 0 which may have screwed up rbbs?
o Couldn't get to first character to edit phone number input.
o Would NOT validate a user if he was the 1st record in the user file!
o Ability to ZAP (remove) all the records from the logfile.dbf added.
o Ability to Remove all records except those marked 'Validated' added.
o Added message to tell user why he was kicked out of door if security
was not ok.
o Tell callback to not call verified #'s and it still calls them!
(configuration set to NO). FIXED.
o Stay online on locals set to No, and it still stays online: FIXED.
o 3 digit prefixes could be found in other area codes and determined
as local to the current areacode.
DISCLAIMER:
This software is guaranteed to work on my system and *hopefully*
on yours. Otherwise, the author specifically disclaims all other
warranties, expressed or implied, including but not limited to
implied warranties of merchantability and fitness for a particular
purpose and theprogram license granted herein in particular, and
without limiting operation of the program license with respect to
2
any particular application, use, or purpose. IN NO EVENT SHALL THE
AUTHOR BE LIABLE FOR ANY LOSS OF PROFIT, LOST SAVINGS, COMMERCIAL
DAMAGE, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
THE USE OR INABILITY TO USE CALLBACK EVEN IF THE AUTHOR Eric J.
Givler HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR
ANY CLAIM BY ANY OTHER PARTY.
WHAT YOU SHOULD HAVE RECEIVED:
CALLBACK.EXE - Main EXEcutable
[CALLBACK.CFG - created during execution with no command-line parameters]
CALLBACK.DOC - This file.
CALLBACK.TXT - Initial entry screen (user editable).
CALLME.BAT - The RBBS batch file called via DOORS. (Sample Only)
CONFIG.DBF - Used during full-screen Configuration data entry.
DORINFO1.DEF - A sample RBBS-PC DORINFO.DEF file
LOGFILE.DBF - Logs callback status
[LOGFILE.NDX - created during program execution for quick-lookups.]
PREFIX.TXT - Sample PREFIX file. CallBack reads this to determine whether
a call is long distance.
FILELIST.TXT - The files in the distribution archive.
CONFIGURING:
Run the program without any command line parameters. Follow the on
screen directions. These are the defaults from the distribution version
for the configuration of the callback program.
1) Does not allow callbacks to "Validated" phone numbers.
2) Only call a number 3 times before no longer attempting.
NOTE: OverRidden by option to not call validated numbers (if set).
3) Blank local dialing prefix.
4) Blank long distance dialing prefix.
5) Use tone (ATDT) instead of pulse (ATDP)
6) Do not validate users if they are long distance.
7) Stay online after a local callback success.
8) Once validated users are upgraded to level 4.
9) My local areacode is 717.
10) Locked baud rate of 19200.
11) Newuser security level is 3.
12) Default RBBS-PC User file and directory is C:\RBBS-PC\USERS
This is where your users file and dorinfo file should reside.
PREFIX.TXT is a list of your local prefixes. You should edit this file to
reflect your local calling area. Each line entry should be either 3 or 6
characters ending with a carriage return/line feed. (6 character lines
are for local numbers in other areacodes. Areacodes are required on every
line that is not in your areacode if it is still local).
The "Dump" option allows you to create a text file of the contents of
the LOGFILE.DBF. This was written for NON-dBase users. It also allows
you to see what problems are being encountered during program execution.
The "R" option - Remove failed callback information will delete any
records in your LOGFILE.DBF that did not result in a Validation. The
database is then packed to save space.
3
The "Z" option - The ZAP option removes all the records in the LOGFILE.DBF.
A sample CALLME.BAT file which could be invoked via the doors is enclosed.
I do NOT include the watchcd program which is usually included with rbbs-pc
or your fossil driver.
EXECUTION:
When this program is being executed (the user exited to this door), you
should see a screen that looks like:
ERIC'S RBBS-PC PASCAL Callback Verifier v0.01a
Reading C:\RBBS-PC\DORINFO1.DEF (possibly different)
FOSSIL: Ray Gwinn's double aught ... (possibly different)
Port : COM<comport>
Baud : <baudrate>
Parity: <parity> (FOSSIL mask for this parity )
Word : <data bits> (FOSSIL mask for the number of databits)
Stop : <stop bits> (FOSSIL mask for the number of stopbits)
First : <user firstname>
Last : <user lastname>
Seclev: <user security level>
Passwd: <user password>
Rec# : <user record number in USERS file>
Then the message screen (callback.txt) will be displayed and the user
will be asked to enter the phone number. If this is not displayed on your
screen:
o Your batch file was not written correctly. Remember to include the %1
in the batch file. CALLBACK will use this 'node number' to look in your
RBBS-PC default directory to find a DORINFO#.DEF file to read.
o You misconfigured the callback program.
o You are running in local mode with the modem turned off. WHY?
o You have a NON-standard com port/IRQ setup.
o Some other error occurred that you(we) must troubleshoot.
ie. In your batch file, it should read: CALLBACK %1
LOGFILE ERROR MESSAGES:
CALLBACK.CFG missing! The callback configuration file: CALLBACK.CFG
was missing. The program does not check for a
missing CONFIG.DBF.
DORINFO?.DEF error! Could not find dorinfo?.def file in rbbs directory.
Security <> # User's security is not equal to the proper security
to use the door (ie. newuser access level)
Userfile open ERROR! Could not open the RBBS user file in the rbbs path or
you misnamed your users file in the configuration.
Not in USERS The user executing this door is not in the USERS
file (not possible?)
Incompatible FOSSIL Your FOSSIL driver is not revision 5 or later.
Failed port open Could not open the comm port determined from the
dorinfo file.
LD call! Logged if ld support is disallowed and user is not
in your local calling exchange or is in another
area code.
4
Invalid phone Invalid phone number entered - the phone number is
not 7 or 10 digits after stripping all numeric
characters and before adding dialing prefixes.
# Already validated This phone number was already validated and you
configured the system to NOT call numbers that are
already validated.
Too many bad calls This message is set if the system detects too many
bad calls to a number and you have configured the
system to limit the number of attempts to a number.
Didn't proceed: x Displays character user entered to request to proceed
if it is NOT y or Y.
Hangup failed Could not hang up the modem after user selected to
proceed with callback. Tries to hangup by dropping
DTR for 1 second.
Callback Timeout Callback failed to connect in 1 minute after
calling the user back. (no carrier) It only tries
to callback one time and does not check for incoming
rings.
Validated User was validated and his security was raised.
Pword: XXXXXXXX User did not enter correct password on all three
attempts. This is his latest attempt.
UPGRADING FROM PREVIOUS VERSION:
If you were using a previous version of callback, all you will need to
use this latest version is to copy the CALLBACK.EXE from the distribution
archive to the directory that you run callback again. *** MAKE SURE TO DO
A SCREEN DUMP OF YOUR PREVIOUS CONFIGURATION OPTIONS AS THIS VERSION USES
A NEW SETUP SYSTEM *** This may seem like a nuisance, but it is so quick
and easy to configure, that I did it this way. It also saves code space
as I didn't want to write conversion routines for reading a dBASE .MEM file
in Pascal. This currently does not apply to upgrading between the Pascal
versions released thus far.
MEMORY USED:
Not sure.
REGISTRATION AND OTHER INFORMATION:
If you have any complaints or problems, please notify me as soon as you can.
This code could be easily modified to run on a networked RBBS system or
support Desqview detection. Comments and suggestions should be mailed to me.
If you like the idea of a callback verifier for RBBS, send a small token
of your appreciation ($15 suggested but anything welcome) to the address
below, and we will ship you the newest version [if one exists] on the
media of your choice. Future upgrades can be obtained by simply writing
me.
Eric J. Givler
133-A Herman Avenue
Lemoyne, Pa 17043
Voice: (717) 763-2055
5